home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
remote
/
tview10.zip
/
TEXTVIEW.DOC
< prev
next >
Wrap
Text File
|
1992-04-05
|
23KB
|
649 lines
▄▓▓▓▓ █▀▀▄ ▄▄ ▄▄▄ ▄▄▄ ▄ ▄ ▄▄▄ █ █ ▄▄ ▄▄▄ ▄▄▄ tm
█▓▓▓▓ █ █ █ █ █ █ █▄ █▀▄█ █ █ █ █ █ █ █ █ █▄
█▓▓▓▓ █▀▀▄ ▀▄▄▀ █▄▄▀ █▄▄ █ █ █ █ █ █▀▀█ █▀▀▄ █▄▄ presents
▀▀▀▀
▄▒▒▒▒ ▀▀█▀▀ ▄▄▄▄ ▄ ▄ ▄▄▄▄▄ █ █ ▄ ▄▄▄▄ ▄ ▄ tm
█▒▒▒▒ █ █▄▄ ▀▄▀ █ █ █ █ █▄▄ ▀▄ ▄ ▄▀
█▒▒▒▒ █ █▄▄▄ ▄▀ ▀▄ █ █ █ █▄▄▄ ▀▄▀▄▀ Version 1.0
▀▀▀▀
▄░░░░ DOCUMENTATION
▀▀▀▀
Online scrollable textfile viewer for
RemoteAccess, QuickBBS, SuperBBS, and others.
Written by Michael Reece.
TextView Program is Copyright (c) 1991-1992 by RodentWare.
TextView Documentation is Copyright (c) 1991-1992 by RodentWare.
All rights reserved.
TextView Version 1.0 Documentation Page i
· T · E · X · T · V · I · E · W · 1 . 0 ·
· b y ·
· R · o · d · e · n · t · W · a · r · e ·
TABLE OF CONTENTS Page
──────────────────────────────────────────────────────────────────────
Purpose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Shareware Notice . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Registration . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Disclaimer & Legal Matters . . . . . . . . . . . . . . . . . . . . . 2
System Requirements . . . . . . . . . . . . . . . . . . . . . . . . 2
Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Loading TextView. . . . . . . . . . . . . . . . . . . . . . . . . . 3
The Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
The File List . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Suggested Uses . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Product Support . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Special Notice . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
RodentWare Support Sites . . . . . . . . . . . . . . . . . . . . . 6
Copyright Notices . . . . . . . . . . . . . . . . . . . . . . . . . 7
Acknowlegements & Credits . . . . . . . . . . . . . . . . . . . . . 8
──────────────────────────────────────────────────────────────────────
TextView Version 1.0 Documentation Page ii
PURPOSE
──────────────────────────────────────────────────────────────────────
TextView is designed to view plain text files online. What makes
TextView unique is the ability to scroll up or down by line or page.
The use of TextView as a door requires ANSI graphics capabilities.
TextView makes use of the JPDOOR door-writing units by Motor City
Software.
TextView allows scrolling up or down single lines, single pages, and
jumps to the beginning or end of the document. TextView has more
impressive "jumping" and searching routines, and it supports text
files up to 20,000 lines long.
SHAREWARE NOTICE
──────────────────────────────────────────────────────────────────────
While this product is distributed freely, it is not free. It has been
released under a software concept known as ShareWare. ShareWare
allows you to evaluate a program to determine if it suits your needs,
and register it with the author if you plan to continue using it. This
means that you have the right to test this product for a period of no
more than thirty (30) days. At the end of the 30 day evaluation
period, you must register your copy with the author, or stop using it.
By registering the ShareWare programs you use, you encourage support
of that product, as well as the creation of other ShareWare products.
The more people who register, the more programmers turn to the
ShareWare concept. Your support of shareware allows programmers to
keep the cost of quality software at an affordable price, thereby
benefitting all users. It's that simple.
REGISTRATION
──────────────────────────────────────────────────────────────────────
There are currently two ways to register a RodentWare product. The
least expensive one-shot method is to register an individual program,
such as this one. The second method is less expensive in the long run,
and registeres you as a "supporter" which entitles you to use any
RodentWare products for your single registration.
After registering your RodentWare products, you will recieve a special
"key file." At startup, all RodentWare programs first check for the
existance of such a key to determine if the program is registered.
Method 1:
For a registration fee of $10.00 (US) you will receive a TEXTVIEW.KEY
registration KEY, valid for TextView only. All versions of TextView
will use the same keyfile, so you will never have to re-register the
same program.
TextView Version 1.0 Documentation Page 1
Method 2:
For a registration fee of $50.00 (US) you will receive a RODENT.KEY
registration KEY, valid for ALL RodentWare programs. All versions of
all RodentWare programs will check for this keyfile. By choosing to
register as a RodentWare "supporter," you will automatically be
registered for ALL RodentWare releases; past, present, and future.
Please see the text file RODENT.REG included in the TextView archive
for detailed registration information.
DISCLAIMER & LEGAL MATTERS
──────────────────────────────────────────────────────────────────────
The software and accompanying materials (including instructions for
use) are provided "as is" without warranty of any kind. Further, the
author disclaims all warranties, expressed or implied, including
without limitation, the warranties of merchantability and of fitness
for any purpose. The author does not warrant, guarantee, or make any
representations regarding the use, or the results of the use, of the
software or written materials in terms of correctness, accuracy,
reliability, currentness or otherwise.
The author shall not be liable for any direct, indirect, consequential
or incidental damages (including damages for loss of business profits,
business interruption, loss of business information, and the like)
which may result from the use or inability to use the software even if
the author has been advised of the possibility of such damages.
You may copy this package for backup purposes. You may also copy and
share unmodified copies of the whole package, providing that the
Copyright Notices are reproduced and included on all copies.
You may not sell the product for a fee and/or distribute the product
along with other products without written permission, nor may you
modify or remove the Copyright Notices from the programs or the
documentation files, or in any way modify, adapt, translate, reverse
engineer, decompile and/or disassemble any of the software in this
package. User clubs, if they are NOT commercial, are allowed to ask a
small amount of money for distribution and storage when they want to
share this package amongst their members.
SYSTEM REQUIREMENTS
──────────────────────────────────────────────────────────────────────
The following equipment, software, and files are necessary to run this
program:
An operational bulletin board system running RemoteAccess,
QuickBBS, SuperBBS, or any other BBS software that creates the
DORINFO1.DEF exit file.
TEXTVIEW.EXE file included in the TextView archive.
TextView Version 1.0 Documentation Page 2
INSTALLATION
──────────────────────────────────────────────────────────────────────
To install TextView for use on your BBS, simply copy the TEXTVIEW.EXE
file to your BBS system directory. More detailed instructions for
configuring TextView for use are given below.
LOADING TEXTVIEW
──────────────────────────────────────────────────────────────────────
TextView can be loaded one of two ways: DIRECT mode, and LIST mode.
The first method is to pass a filename on the command line to be
viewed directly. Here, TextView loads this file and displays it to the
screen immediately. Upon exiting the viewer, TextView returns to DOS
(or the BBS). This mode would be ideal for viewing a single file from
a BBS menu option, such as a SysOp option to browse the caller log, or
a user option to browse a help file or door instruction file.
To load TextView in this manner, use the following command line:
TEXTVIEW.EXE DIRECT <filename> [filepath]
where <filename> is the file you wish to view, and [filepath] is
optionally the path to <filename>. Note that <filename> may be a
complete path, in which case [filepath] is not needed. Thus,
TEXTVIEW.EXE DIRECT C:\RA\RA1.LOG
and
TEXTVIEW.EXE DIRECT RA1.LOG C:\RA\
are functionally the same. However, only the portion given as the
<filename> parameter is displayed to the screen in the header line.
Thus, in the first example above, "C:\RA\RA1.LOG" would be displayed
on the first header line in the viewer, while in the second example,
only "RA1.LOG" would be displayed.
The second method is to pass a FILES.BBS type listing on the command
line. TextView will then allow the user to select a file from this
listing to be loaded into the viewer. Each time the viewer is exitted,
the user is returned to the listing. Exitting the listing returns to
DOS (or the BBS) in this mode. This method might be useful as an
option on a File Menu, to allow users to view files in the current
file area. Or, you might create a seperate FILES.BBS style listing of
files that can be viewed.
To load TextView in this manner, use the following command line:
TEXTVIEW.EXE LIST <filename> [filepath]
where <filename> is the complete path and name of a FILES.BBS type
listing, and [filepath] is the path to the actual files listed in
TextView Version 1.0 Documentation Page 3
<filename>. For example, if the command line
TEXTVIEW.EXE LIST C:\RA\LISTS\FILES.3 C:\RA\UPLOADS\
is used, "C:\RA\LISTS\FILES.3" is expected to be a FILES.BBS type
listing, and the files listed in "C:\RA\LISTS\FILES.3" are actually
in the directory "C:\RA\UPLOADS\". If both the listing and the files
to be viewed reside in the same directory, the filepath is not
necessary:
TEXTVIEW.EXE LIST C:\RA\UPLOADS\FILES.BBS
Taking advantage of RemoteAccess's file template structure, the
following command line could be used on a type 7 exit:
TEXTVIEW.EXE LIST *0FILES.BBS
assuming that the path passed by RA has a trailing backslash.
Because TextView uses a good deal of memory (240k in some cases) it is
recommended that you enable the memory swapping functions for your BBS
software. For example, with RA this is done by placing a "*M" on the
command line as well, such as:
TEXTVIEW.EXE *M LIST C:\TXTDESCS\LIST1.TXT C:\TXTFILES\
TextView should be called from a type 7 (DOS shell) menu option. A
type 15 (DOS exit) option would work as well, but is not really
needed, especially when the memory swapping feature is used. For more
information on creating menu options, please refer to your BBS manual
or documentation.
THE VIEWER
──────────────────────────────────────────────────────────────────────
The viewer consists of a header line, a footer line, and 21 lines of
scrolling text. The header line displays the name of the file being
viewed. In DIRECT mode, this will be the name passed as the <filename>
command line parameter. In LIST mode, this will be the 12 character
name of the file selected from the list. In LIST mode, the file's
description is also displayed on the header line. The footer line
shows the string "Use NUMLOCK keys, ESC-Exit, ?-Help." and the lines
currently being displayed in the scroll window in the form "Lines x_1
to x_2 of x_N."
The 21 line scroll window is updated as the user scrolls through the
text file. The following keys can be used to move through the text:
Movement NUM WordStar
-----------------------------------------------
End of text (End) 1 ^Z
Down one line (Down) 2 ^X
Down one page (PgDn) 3 ^C
Top of text (Home) 7 ^Q
Up one line (Up) 8 ^W
Up one page (PgUp) 9 ^E
TextView Version 1.0 Documentation Page 4
Other Commands Key
-------------------------------
Jump to line J
Search for text S
Note that the 1,2,3,7,8,9 keys correspond to normal cursor movement
keys when in NUMLOCK mode. The WordStar control characters are also
provided because these are well known.
Pressing 'J' in the viewer will prompt the user for a line number.
TextView will quickly "jump" to this line.
Pressing 'S' in the viewer will prompt the user for a search string.
Entering '/' as the search string will search for the next occurance
of the previous search string. Pressing [Enter] at the search prompt
disables the current search string. TextView will highlight all
occurances of the search string on the screen.
Pressing '?' in the viewer will bring up a small window displaying
the keys that are available to the user.
Pressing [Esc] or 'Q' will exit the viewer. In DIRECT mode, this exits
the program. In LIST mode, this returns the user to the filename list
to select a new file.
THE FILE LIST
──────────────────────────────────────────────────────────────────────
The file list consists of a header line, a footer line, a listing of
19 filenames and their descriptions, and a key entry prompt.
TextView supports up to 500 filenames, and displays them to the screen
19 at a time. The following keys are options in the file list:
(N)ext
The Next option displays the next screen of filenames.
(P)rev
The Prev option displays the previous screen of filenames.
(R)edraw
The Redraw option redraws the current screen of filenames. This
command is useful in case of line noise. Pressing '?' works here
as well.
(V)iew
The View option asks for a file number to display, and loads the
selected file into the file viewer.
(Q)uit
The Quit option exits the program and returns to the BBS or DOS
prompt. [Esc] also works for this option.
TextView Version 1.0 Documentation Page 5
SUGGESTED USES
──────────────────────────────────────────────────────────────────────
TextView has many uses that may not immediately come to mind. The
following suggestions may help you come up with new uses for this
program.
As shown in the examples above, TextView can be used as a "(V)iew Text
File" option on your file transfer menu.
TextView could be used to scroll various online game documents or
high score listings.
A group of local SysOps could exchange master file listings. Users
could then view and search file listings for other area BBSs on your
BBS in case they cannot find a file they need online.
TextView could be used in the DIRECT mode for remotely viewing your
BBS or mailer log files, user questionnaire files, or any other
variety of textfiles.
And lots of other stuff, too, I'm sure. :-)
PRODUCT SUPPORT
──────────────────────────────────────────────────────────────────────
There is a RodentWare support echo titled 'RODENT' on the Fidonet
Backbone. The RODENT echo is to aid support to all RodentWare users
without adding more wear and tear on the other echoes. Ask your *EC
about receiving this echo -- it is on the Fidonet Zone 1 BACKBONE!
SPECIAL NOTICE
──────────────────────────────────────────────────────────────────────
A special thank you goes out to all of the RodentWare supporters, beta
testers, and support echo participants. There has never been a better
bunch of supportive people. Thanks, guys (and gal), for sticking in
there through the long, long winter!
Additionally if you would like to become a member of the beta team or
support network, please contact Michael Reece.
RODENTWARE SUPPORT SITES
──────────────────────────────────────────────────────────────────────
Below is a listing of RodentWare Support Sites. These bulletin boards
should have all of the latest RodentWare programs available for File
REQuest and/or Download.
The RodentWare BBS (SysOp, Michael Reece)
RodentWare Headquarters
Buffalo NY
1-716-837-6879, 1:260/150, 9600 [HST]
TextView Version 1.0 Documentation Page 6
Odyssey BBS (SysOp, Stan Hirschman)
RodentWare Distribution
Edina MN
1-612-832-5127, 1:282/40, 9600 [HST,V32b,V42b]
The Dart Board (SysOp, Karen Maynor)
RodentWare Distribution
St Mary's GA
1-912-882-0755, 1:3640/5, 9600 [HST,V32b]
MCS * USA * (SysOp, Peter Kling)
Albany NY
1-518-437-1267, 1:267/169, 9600 [HST,V42b]
1-518-437-1268, 1:267/269, 2400
Dave's Hangar (SysOp, Dave Hartzell)
Dallas TX
1-214-363-1973, 1:124/2114, 9600 [HST,V32b,V42b]
Happy Hour BBS (SysOp, Tom Stoltz)
Raymore MO
1-816-322-1133, 1:280/301, 9600 [HST]
The Dog Bone BBS (SysOp, Daniel Svanstrom)
Atlanta Ga
1-404-458-4924, 1:133/412, 9600 [CSP,V32b,MNP]
The Dog House (SysOp, Dave Lockard)
Charlotte Hall MD
1-301-884-3686, 1:109/605, 2400
The Comedy Club (SysOp, Richard Williams)
W. Frankfort IL
1-618-937-1831, 1:2290/20, 2400
The End of the World (SysOp, Lou Ludwig)
Ewa Beach HI
1-808-499-1501, 1:345/20, 9600 [HST,V42b]
The Low Country (SysOp, Tom Echols)
Tillman SC
1-803-726-5191, 1:3626/8, 9600 [HST,V32b,V42b]
The Master's BBS (SysOp, Mike Levonius)
Garden Grove CA
1-714-539-9087, 1:103/101, 2400
1-714-539-2477, 1:103/102, 9600 [HST]
The Midrange System (SysOp, David Gibbs)
Mount Prospect IL
1-708-439-9679, 1:115/439, 9600 [HST,V32b,V42b]
1-708-439-1458, 2400 [V42b]
The Other Side Of The Hill (SysOp, Robby Barra)
Tyler TX
1-903-597-1239, 1:3801/3, 9600 [HST,V42b]
TextView Version 1.0 Documentation Page 7
COPYRIGHT NOTICES
──────────────────────────────────────────────────────────────────────
TextView Version 1.0 Copyright (c) 1991 by RodentWare.
Written by Michael Reece, The RodentWare BBS, 716-837-6879, 1:260/150.
RodentWare, 24 Hawthorne Ave, Buffalo NY 14223-3014, USA.
Voice: 716-837-4741, 3 pm to 10 pm.
ACKNOWLEGEMENTS & CREDITS
──────────────────────────────────────────────────────────────────────
Michael Reece and RodentWare would like to thank the following:
Borland International, Inc. for Turbo Pascal 6.0
Andrew Milner & Continental Software for RemoteAccess.
Motor City Software for JPDoor 3.2.
John Parlin for his similar JPList program.
The Fidonet PASCAL echo for coding help and suggestions.
Turbo Pascal is a trademark of Borland International, Inc.
RodentWare is a trademark of Michael Reece & RodentWare.
RemoteAccess is a trademark of Andrew Milner & Continental Software.
**********************************************************************
* SysOps: We thank you for making our programs available on your BBS *
* for downloading. Please do not add files to the original archive. *
* BBS ads are welcome in the archive COMMENT only! Do not place new *
* files, or modify existing files, INSIDE the archive. Changing *
* archive format (ie, from ARJ to ZIP or LZH) is fine as long as you *
* are positive that ALL of the original files (and no EXTRA files) *
* are placed inside the new archive. - RodentWare *
**********************************************************************
Enjoy.
Michael Reece, RodentWare Programmer
TextView Version 1.0 Documentation Page 8